Blogger | Thẻ b:widget cho Blogger

1. Khái niệm: 

Các thẻ <b:widget> được gọi là Tiện ích là một ứng dụng nhỏ chứa nhiều mã và thuộc tính quy ước với trình phân tích XML theme của Blogger.

Căn cứ vào các thuộc tính và nội dung của <b:widget> server sẽ render ra nội dung cho blogger từ các thẻ b:data 

Tiện ích chỉ có thể được cài đặt bên trong thẻ <b: section>.

2. Cú pháp: 

<b:widget id='STRING'
          cond='EXPRESSION'
          locked='BOOLEAN'
          version='NUMBER'
          title='STRING'
          type='WIDGET_TYPE'
          mobile='BOOLEAN'
          visible='BOOLEAN'>
</b:widget>

2.1. id: id của thẻ <div> sẽ được sinh ra khi blogger trả về cho browser.

2.2. cond: biểu thức trả về true/false, quyết định việc widget có được generate hay không

Như dưới đây là một widget chỉ được xuất hiện ở page bài đăng: 

cond='data:view.isPost'

2.3. locked: true/false, quyết định widget có được thay đổi vị trí bởi thao tác kéo thả trong mục chỉnh sửa Bố Cục.

2.4. version: version của widget

2.5. title: tiêu để của widget, tiêu đề này có thể lấy được từ thẻ data.

Ví dụ như dưới đây: 

title='Bài viết nổi bật'

2.6. type: tên của widget, quyết định widget thuộc loại gì, và ứng với mỗi loại coa một tập các thuộc tính và data ta có thể truy xuất khác nhau.

Ví dụ: 

type='logo'

2.7. mobile: true/false, quyết định widget có được hiển thị trên mobile hay không. 

Nếu là false, mã HTML của widget sẽ không đc tạo ra trên mobile, tức là sẽ không hiển thị bất cứ điều gì về widget đc set thuộc tính này.

2.8. visible: true/ false, quyết định widget có được hiển thị hay không. 

Như dưới đây, nếu mobile="true" nhưng visible="false", thì widget vẫn không được hiển thị trên mobile.

mobile='true' visible='false'

3. Các loại widget: 

type='WIDGET_TYPE'

• Globally Available Data
• Page Header
• Blog Posts
• Blog Archives
• Profile
• Text / HTML / JavaScript
• Feed
• Picture
• Labels
• List
• Link List
• Logo

Ví dụ: Blog Posts widget thì có type="blog". 

Trong Blog Posts widget để đánh dấu các điểm dùng data blogger, ta dùng các thẻ <b:data:... />

<b:data:posts /> thẻ này đánh dấu list các post, tuy nhiên để sử dụng loại data này, ta phải dùng b:loop, ví dụ cụ thể như sau: ( việc chi tiết về b:loop sẽ được nói đến cụ thể hơn ở bài viết khác )

<b:loop var='eachPost' values='data:posts'>
      <h2><data:eachPost.title/></h2>
</b:loop>

Với 'eachPost' coi như một định danh mới ta đặt ra để truy cập vào từng phần tử của data:posts. 

4. Chú ý: 

Các data khi được đặt trong các biểu thức - gọi đến trong thuộc tính của các thẻ b: thì được gọi như sau: 'data:posts'

Còn khi được sử dụng như một thẻ độc lập, thì ta cần dùng thẻ data dạng singleton. Ví dụ như ở trên là: 

<h2><data:eachPost.title/></h2>

hoặc

<a expr:href="data:newerPageUrl" >
	<data:newerPageTitle />
</a>