katext

katext.js სკრიპტის გამოყენება

ქართული ვებგვერდისთვის გამოსადეგი ფუნქციები. ვერსი 0.4.2

ზოგადი

ზოგადი ის შემიძლია ვთქვა რომ არის ასეთი ცვლადი ka_debug, დეფოლტად - false, თუ მიანიჭებ trueს, სკრიპტი გამოიტანს შეტყონებებს შეცდომების დროს.

kaklav ობიექტის(კლავიატურის გადამყვანი) გამოყენება

ჯერ რათქმაუნდა, უნდა ჩაწერო სადმე: <script src="katext.js" > </script> მერე: <body onload="klava=new kaklav("პარამეტრები")">ეს ნებისმიერ ადგილასაც ჩაისმება რათქმაუნდა. თუ იყენებთ tinymce-სთან ერთად, აუცილებლად -მდე უნდა იყოს. მოკლედ ბადიმდე ჩაწერე, არავითარი ონლოუდ. "პარამეტრები" არი ობიექტი ანუ უნდა იყოს ასეთი სახით: {პარამ: 'მნიშვნელობა',სხვაპარამ: 'კიდემნიშვნელობა', ა.შ.} მაგ: new kaklav({elements: 'mytextarea',layout: 'kalat',cap:'no'})არცერთი პარამეტრი სავალდებულო არაა. შეგიძლია ასე ჩაწერო, თუ გაწყობს დეფოლტები: onload=”klav=new kaklav()" და ვსო მზათაა. ახლა რა პარამეტრებია:

elements: რომელ ელემენტებზე უნდა მუშაობდეს კლავიატურის გადამყვანი. ეს არის კლასის სახელი. თუ კლასს თავში უწერია -, კლავიატურა იმუშავებს ყველა ელემენტზე გარდა ისეთებისა რომლებსაც აქვთ ეს კლასი, თუარადა იმუშავებს მარტო იმათზე რომლებსაც აქვთ ეს კლასი. თუ არ არი მითითებული, იგულისხმება ყველა ელემენტი.მაგ:"-nokbd"-ნიშნავს რომ უნდა იმუშაოს ყველა ელემენტზე გარდა იმათი, რომლებსაც აქვთ კლასი nokbd. "inputbox"-იმუშავებს იმ ელემენტებში, რომლებსაც აქვთ კლასი(ერთერთი კლასი) "inputbox"
layout: განლაგება. 3 ვარიანიტა: kalat ან kabpg, ან winka. kalat, ჩვენი მამაპაპური, არის დეფოლტი. kabpg არი კაი განლაგება, ძირითადში გავს ლათინურს, უბრალოდ ყველა ასო ცალკე კლავიშაზეა, ადვილი სასწავლია. ალტ+ასოები არ მუშაობს.
enc: 2 ვარიანტია: uni ან std8. uni-უნიკოდი, std8 1ბაიტიანი ქარტული კოდირებისთვის, მაგ. ფონტისთვის Geo_Times. გამოიცანი რომელია დეფოლტი:)
cap: დიდი ასოების ამბავი. 3 ვარიანტია: tosmall : დიდი ასოც პატარა იქნება, მაგ. D=>დ,d=>დ. tocap: გადავა მთავრულ ასოებში. sylfaen-ში ეს ასოები რაა, Arial Unicode MS-ში ძველ-ქართული ასოებია, bpg-ს ფონტებში - მსხვილი. ამას აზრი აქ როცა layout=kabpg იმიტომ რომ kalat-ით ყველა მთავრულ ასოს ვერ დაწერ. და მესამე ვარიანტი: ამ 2 სგან განსხვავებული: გინდ "", გინდ "no"... მაშინ მამაპაპურად იქნება - D=>D. ესაა დეფოლტი.
useold5: true ან სხვა რამე. დეფოლტად true იქნება,თუ განლაგებას ლათინურს აირჩევ. როცა თრუა,5 ასო-YUIOP გადადის 5 ძველქართულ ასოში,ჱჲჳჴჵ.
checkbox: ჩექბოქსის id რომლითაც შეიძლება ქართული კლავიატურის ჩართვა გამორთვა.
ctrlchar: ასო. დეფოლტად ` . ამ კლავიშაზე დაჭერით შეგიძლია ჩართო-გამორთო ქართული კლავიატურა.
switcher: ასო(დეფოლტად - ~). ამ კლავიშაზე დაჭერით გააქტიურდება მომდევნო განლაგება
tinymce: ობიექტი. თუ ეს წერია, ესეგი გინდა tiny mce WYSIWYG editor ის გამოყენება. აქ მიეთითებ ყველა პარამეტრი, რომელიც მიეთითება ტინიმცეს თავის ინიტში. მაგრამ, თუ ამას დაწერ, ინიტს დაწერა არ გჭირდება, არაფრის თინიმცესთან დაკავშირებულს არ წერ სხვაგან! კლავიატურა ოპერაში არ მუშაობს. თვითონ თინიმცე ჩაირთვება ჩვეულებრივ, უბრალოდ ქართულად ვერ დაწერ ამ სკრიპტით.

არი 4 მეთოდი რომლებითაც შექმნილი ობიექტისთვის შეგიძლია ოფციების შეცვლა: setLayout, setEnc, setCap, setUseOld5, ამათ მიეწოდებათ ერტი პატამეტრი ზუსტად ისე როგორც ზევით ვთქვი.

ტექსტის კონვერტირების ფუნქციების გამოყენება

ტექსტის კონვერტირებისთვის 2 ფუნქციაა: String კლასის მეთოდი toEnc და ელემენტის დასაკონვერტირებელი ka_elemConvert

toEnc იღებს 2 პარამეტრს - ახლანდელი და სასურველი კოდირება. აბრუნებს გადაყვანილ ტექსტს. კოდირება შეიძლება იყოს: 'uni','lat','std8'.პარამეტრები აუცილებველი არაა, დეფოლტით იღებს lat-ს როგორც ახლანდელს და 'uni' როგორც სასურველ კოდირებას.

var s=’აბგდ'; s=s.toEnc('uni','lat'); s გახდა 'abgd'; s='abrakadabra'.toEnc(); s გახდა 'აბრაკადაბრა'.

ka_elemConvert იღებს 4 პარამეტრს: გადასაკონვერტირებებლი html ელემენტის id ან თვითონ ელემენტი, ახლანდელი და სასურველი კოდირება, და კიდევ ერთი. აუცილებელია მხოლოდ პირველი, მეორე და მესამე წინა ფუნქციასავითაა. ეს მეოთხე პარამეტრი მუშაობს მხოლოდ ფორმის ელემენტებზე. უამისოდ კი ეს ფუნქცია მუშაობს html ელემენტებზეც(მოხდება ელემენტის და მისი შთამომავლობის კონვერტირება), მაგ.:ka_elemConvert(document.body) გადაიყვანს მთელ გვერდს ლათინურიდან უნიკოდ კოდირებაში - შეცვლის ყველა ელემენტის ტექსტურ შიგთავსსა და value ატრიბუტს. დავუბრუნდეთ მეოთხე პარამეტრს: ეს განსაზღვრავს უნდა მოხდეს მთელი ელემენტის ტექსტის თუ მხოლოდ მონიშნული ნაწილის გადაყვანა. თუ არ არი მითითებული, გადაიყვანს მთლიანად, თუ 1ის ტოლია, გადაიყვანს მხოლოდ მონიშნულს, თუ 1 ისგან განსხვავებულია, გადაიყვანს მხოლოდ მონიშნულ ნაწილს თუ რამეა მონიშნული, თუარადა მთლიან ტექსტს.

მთავრული ასოების კონვერტირება

ბპგ ინფოტექის ზოგი შრფიტი შეიცავს მთავრულ ასოებს, ესენი ფართო მონოსიმაღლის ასოები არიან და ბევრი იყენებს სათაურებში. მაგრამ არის ერთი პრობლემა, თუ კლიენტს არ აქვს ბპგ-ს შრიფტებნი, ის მთავრულ ტექსტს ძველი ქართული ასოებით დაინახავს. ამ პრობლემის მოსაგვარებლად დაიწერა ფუნქცია ka_convMtavr();ეს ფუნქცია გაიგებს აქვს თუ არა კლიენტს ბპგ-ს ცნობილი 3 შრიფტი: BPG Glaho Arial, BPG Glaho Arial V5, ან BPG Glaho Verdana და თუ არცერთი არ აქვს, გადააკონვერტირებს ყველა მთავრულ ტექსტს ვებგვერდზე ნუსხურში(ჩვეულებრივში). ეს სავარაუდოდ onloadში დაგჭირდება. არის კიდევ ერთი ფუნქცია - ka_canDisplayBig() რომელიც აბრუნებს true-ს თუ ის 3 შრიფტი დაყენებულია. ამის სავარაუდო გამოყენება იქნება ის, რომ თუ არ აქვს ეს შრიფტები, შესთავაზო კლიენტს მაTი გადმოწერა.

დამატებითი ფუნქციები

არის რამდენიმე დამხმარე ფუნქცია, რომელიც არ არი დაკავშირებული ქართულ ენასთან.
filterByClass(elem,crit) - აბრუნებს აკმაყოფილებს თუ არა elem(ეს არის ელემენტი ან მისი id) კრიტერიუმს, რომელიც არის კლასების სია, ზუსტად ისეთივე რამეა როგორც elements პარამეტრი არი kaklav ობიექტისთვის.
among - Number ტიპის მეთოდი. აბრუნებს ტოლია თუ არა ეს რიცხვი რომელიმე პარამეტრის. mynum=4; mynum.among(1,2,5)==false, mynum.among(12,3,4)==true
amongi - String ტიპის მეთოდი, აბრუნებს ტოლია თუ არა ეს სტრინგი რომელიმე პარამეტრის, არა-რეგისტრის-მიმართ-მგრძნობიარეა. 'abgd'.amongi('abg','abgde')==false, 'abgd'.amongi('ABGd','abGd')==true;
$() იღებს განუსაზღველი რაოდენობის პარამეტრს, რომელთაგან თითოეული არის ელემენტი ან ელემენტის id,და აბრუნებს ელემენტს, თუ პარანმეტრი ერთი იყო, ან ელემენტების მასივს. კარგი ფუნქციაა. გადმოკოპირებულია prototype ჯავასკრიპტ ბიბლიოთეკიდან. მაგ: alert($('mytextarea').value); ka_isKbdInput - აბრუნებს არის თუ არა პარამეტრად გადაცემული ელემენტი ტექსტის შესატანი ობიექტი.

სკრიპტის ავტორები: მიშა ამაშუკელი( amashukeli@gmail.com ), ჯერჯერობით მეტი არავინ. სკრიპტი ოუფენსორსია, შეგიძლია შეიტანო მასში ცვლილებები და გამოგვიგზავნო. სასარგებლო გაუმჯობესებებს შევიტანთ სკრიპტის შემდგომ ვერსიაში.

ქართული კლავიატურა:
განლაგება:
დიდი ასოები:
კოდირება:
5ძველი ასო:

ტექსტის გადაყვანა.
ახლანდელი კოდირება:
სასურველი კოდირება:
ის მეოთხე პარამეტრი:
გადაყვანა

არის დაყენებული BPG Glaho Arial, BPG Glaho Arial V5, ან BPG Glaho Verdana?
გადააკონვერტირე მთავრული ტექსტი თუ არ არი ზემოთ ჩამოთვლილი შრიფტები დაყენებული
გადააკონვერტირე მთავრული ტექსტი ნებისმიერ შემთხვევაში.
მაგალითი: ႫႠႢႠႪႨႧႨ