ถัดไป ก่อนหน้า

4.3 Methods & Utilities

   jQuery Mobile เปิดให้ใช้หลายๆเมธอดและคุณสมบัติใน $.mobile ที่เป็นอ๊อฟเจ็คสำหรับใช้ในแอพพลิเคชันของคุณ
$.mobile.changePage()
   เมธอดนี้ใช้สำหรับการโหลดภายในหน้าเพจและการเปลี่ยนแปลงที่เกิดขึ้นที่เป็นผลมาจากการคลิกลิงค์หรือการกรอกฟอร์มเมื่อฟีเจอร์เหล่านี้ทำงานอยู่

Arguments

• to (string or object, required)
     String: URL ที่เป็นลักษณะเต็มหรือ URL ที่เป็นในลักษณะความสัมพันธ์
     Object:การเก็บอ๊อฟเจ็คของ jQuery ตัวอย่างเช่น ($("#about"))

options (object, optional)

คุณสมบัติ:

   allowSamePageTransition (boolean,ค่าเริ่มต้น:false) โดยปกติ changePage() ละเว้นการร้องขอที่จะเปลี่ยนไปหน้าเพจที่ทำงานปัจจุบัน ตั้งค่าให้เป็น true ช่วยในการร้องขอเพื่อการดำเนินการ

• changeHash (boolean,ค่าปกติ:true) ตัดสินใจหากการ hash ในพื้นที่แถบบาร์จะต้องอัพเดท
• data (object หรือ string,ค่าปกติ:ไม่พบ)ข้อมูลที่ส่งด้วยการร้องขอจากหน้าเพจ Ajaxใช้เฉพาะเมื่อ to เป็นอากิวเมนต์ของฟังก์ชัน changePage() ที่เป็น URL
• dataUrl (string,ค่าปกติ:ไม่พบ) URL ที่ใช้เมื่อมีการอัพเดทที่บราว์เซอร์เมื่อ changePage เรียบร้อยหากไม่ได้ระบุค่าของแอตริบิวต์ data-url องค์ประกอบของหน้าถูกนำมาใช้
• pageContainer (ชุดคำสั่ง jQuery,ค่าปกติ:$.mobile.pageContainer) ระบุองค์ประกอบที่ควรมีในหน้าเพจ reloadPage (boolean, ค่าปกติ: false) บังคับโหลดหน้าเพจถึงแม้ว่าเหตุการณ์นี้มีอยู่แล้วใน DOM ของหน้าเพจใช้เฉพาะเมื่อ to เป็นอากิวเมนต์ของ changePage() ที่เป็น URL.
• reverse (boolean,ค่าปกติ:false)ตัดสินใจว่าคำสั่งไหนที่เปลี่ยนแล้วจะรันเมื่อมีการแสดงหน้าเพจ
• role (string,ค่าปกติ:ไม่พบ) data-role ใช้ตัวแปลเมื่อแสดงหน้าเพจโดยปกติแล้วจะไม่พบสิ่งนี้ซึ่งซึ่งหมายความว่าพึ่งพาค่าของแอตริบิวค์ @data-role ที่กำหนดไว้ในองค์ประกอบ
• showLoadMsg(boolean,ค่าปกติ:true)ตัดสิ้นใจว่าจะแสดงหรือไม่แสดงข้อความในขณะที่โหลดหน้าเพจแมื่อมีการโหลดไปยังนอกหน้าเพจ
• transition(string,ค่าปกติ:$.mobile.defaultPageTransition)เป็นการเปลี่ยนที่ใช้ในขณะที่แสดงหน้าเพจ
• type (string, ค่าปกติ: "get")ระบุเมธอด("get" หรือ "post")ที่ใช้เมื่อมาร์กการร้องขอหน้าเพจ ใช้เฉพาะเมื่อ to เป็นอากิวเมนต์ของchangePage() ที่เป็น URL

//transition to the "about us" page with a slideup transition
$.mobile.changePage( "about/us.html", { transition: "slideup"} );
//transition to the "search results" page, using data from a form with an id of "search"
$.mobile.changePage( "searchresults.php", {
	type: "post",
	data: $("form#search").serialize()
});
//transition to the "confirm" page with a "pop" transition without tracking it in history	
$.mobile.changePage( "../alerts/confirm.html", {
	transition: "pop",
	reverse: false,
	changeHash: false
});

$.mobile.loadPage()
   เมธอดนี้เป็นการเรียกใช้ภายในฟังก์ชัน changePage() เมื่ออาร์กิวเมนต์แรกคือ URL , ฟังก์ชั่นนี้จะไม่ส่งผลกระทบต่อเพจที่ใช้งานในปัจจุบันเพื่อที่จะสามารถใช้เป็นเบื้องหลังในการโหลดหน้าเพจ,ฟังก์ชันนี้จะส่งอ๊อฟเจ็คกลับผ่านการยืนยันนั้นโดยได้รับการแก้ไขภายหลังการเพิ่มหน้าเพจและเพิ่มเข้าไปใน doument

อากิวเมนต์

   url (string หรือ object, required) เป็นURLแบบรีเลชันหรือURLแบบเต็ม

options (object, optional)

คุณสมบัติ

• data (object หรือ string,ค่าปกติ:ไม่พบ) ข้อมูลที่ส่งผ่านการเรียกจากหน้าเพจด้วย Ajax
• loadMsgDelay (number (in ms), ค่าปกติ: 50) บังคับให้ดีเลย์ก่อนการโหลดแสดงข้อความ
• pageContainer (jQuery collection,ค่าปกติ: $.mobile.pageContainer)ระบุองค์ประกอบที่ควรมีที่หน้าเพจหลังจากที่มีการโหลด
• reloadPage (boolean, ค่าปกติ: false) บังคับให้กลับไปโหลดหน้าเพจถึงแม้ว่ามันจะมีอยู่แล้วใน DOM ของพื้นที่หน้าเพจ
• role (string,ค่าปกติ:ไม่พบ) data-role ใช้ตัวแปลเมื่อแสดงหน้าเพจโดยปกติแล้วจะไม่พบสิ่งนี้ซึ่งซึ่งหมายความว่าพึ่งพาค่าของแอตริบิวค์ @data-role ที่กำหนดไว้ในองค์ประกอบ
• showLoadMsg(boolean,ค่าปกติ:true)เป็นการตัดสิ้นใจว่าจะแสดงหรือไม่แสดงข้อความในขณะที่ โหลดหน้าเพจแมื่อมีการโหลดไปยังนอกหน้าเพจ
• transition (string,ค่าปกติ:$.mobile.defaultPageTransition)เป็นการเปลี่ยนที่ใช้ในขณะที่แสดงหน้าเพจ
• type (string, ค่าปกติ: "get") ระบุเมธอด("get" หรือ "post")ที่ใช้เมื่อมาร์กการร้องขอหน้าเพจ
  ใช้เฉพาะเมื่อ to เป็นอากิวเมนต์ของchangePage() ที่เป็น URL

ตัวอย่าง

//load the "about us" page into the DOM
$.mobile.loadPage( "about/us.html" );

//load a "search results" page, using data from a form with an id of "search"
$.mobile.loadPage( "searchresults.php", {
	type: "post",
	data: $("form#search").serialize()
});

$.fn.jqmData(), $.fn.jqmRemoveData()

   เมื่อมีการทำงานร่วมกับ jQuery mobile jqmData และ jqmRemoveData ควรจะใช้ที่ jQuery core ของเมธอด data และ remoneData(note รวมถึง $.fn.data, $.fn.removeData และ $.data, $.removeData และ $.hasData utilities) เมธอดทั้งหมดนี้เป็นการทำงานร่วมกันอัตโนมัติที่จะรับค่าและเซ็ตค่าของข้อมูลแอตริบิวต์ namespaced (แม้ว่าในปัจจุบันจะไม่มีการใช้งาน namespace ในปัจจุบัน)

อากิวเมนต์:พบเมธอด data และ removedata ของ jQuery

Note: การเรียกใช้ jqmData() โดยไม่ใช้อากิวเมนต์จะรีเทิร์นการไม่พบค่ากลับไป พฤติกรรมนี้จะมีการปรับเปลี่ยนในเวอร์ชันหน้าต่อไป

ความเหมือนกัน:

ยกตัวอย่าง แทนการเรียกใช้ $("div[data-role='page']") คุณควรจะใช้ $("div:jqmData(role='page')")แทน

• $.fn.jqmEnhanceable()

   สำหรับผู้ใช้ที่ต้องการที่จะใช้เกี่ยวกับ data-enhance=false เป็นองค์ประกอบหลักระหว่างการเพิ่มประสิทธิภาพการใช้งานหรือปลั๊กอินที่กำหนดเองการเขียน

jQuery Mobile ที่จะเอื้อให้กับเมธอด $.fn.jqmEnhanceable

การตั้งค่า:

ถ้าหากใช้แต่เพียง $.mobile.ignoreContentEnabled ต้องตั้งค่าให้เป็น true วิธีการนี้จะเข้าไปโหนดหลักของแต่ละองค์ประกอบ DOM ใน jQuery อ๊อฟเจ็คและพบที่ data-enhance=false

ข้อควรระวัง:
   การดำเนินงานขององค์ประกอบภายในขององค์ประกอบรวมทั้งหมดสามารถมีความสิ้นเปลืองถึงแม้ว่าจะมี
การตั้งค่าที่เล็กของอ๊อฟเจ็ค jQuery ก็ตาม

• $.fn.jqmHijackable()

   สำหรับผู้ใช้ที่ต้องการที่จะใช้ data-ajax=false องค์ประกอบหลักในรูปแบบที่กำหนดเองและการเชื่อมลิงค์jQuery Mobileให้เข้ากับการ ใช้ในเมธอด $.fn.jqmHijackable

การตั้งค่า:

   ถ้าหากใช้แต่เพียง $.mobile.ignoreContentEnabled ที่ตั้งค่าเป็น true วิธีการนี้จะเข้าไปโหนดหลักของแต่ละองค์ประกอบ DOM ใน jQuery อ๊อฟเจ็ค และพบที่ data-enhance=false

ข้อควรระวัง:

   การดำเนินงานขององค์ประกอบภายในขององค์ประกอบรวมทั้งหมดสามารถมีความสิ้นเปลืองถึงแม้ว่าจะมี
การตั้งค่าที่เล็กของอ๊อฟเจ็ค jQuery ก็ตาม

• $.mobile.loading()
     ใช้แสดงหรือซ่อนข้อความการโหลดหน้าเพจซึ่งจะกำหนดผ่าน $.mobile.loader

Object Param Arguments

   theme (string, ค่าปกติ: "a") ธีมของแถบสำหรับข้อความ

   text (string, ค่าปกติ: "loading") ตัวอักษรสำหรับข้อความ

   textonly (boolean, ค่าปกติ: false) ถ้าเป็น true การหมุนของภาพควรที่จะหายเมื่อข้อความนั้นแสดง

   textVisible (boolean, ค่าปกติ: false) ถ้าเป็น true ตัวแปลที่เป็น text ควรที่จะให้อยู่ใต้การหมุน

   html (string, ค่าปกติ: "") ถ้าตั้งค่าให้เป็นตัวแปลว่างมันจะถูกใช้แทนทั้งหมดของการโหลดภายใน html

ตัวอย่าง

//cue the page loader
$.mobile.loading( 'show' );
//use theme swatch "b", a custom message, and no spinner
$.mobile.loading( 'show', { theme: "b", text: "foo", textonly: true });