Hướng dẫn công cụ
Về XML Formatter
XML formatter biến XML bị minify hoặc do máy sinh ra thành markup có indent rõ ràng để bạn đọc được thật sự.
Dán response API, file cấu hình hoặc SOAP envelope, rồi format lại, nén về một dòng, hoặc duyệt dưới dạng cây có thể thu gọn.
Cách dùng XML Formatter
- Dán XML của bạn, hoặc tải lên file .xml.
- Bấm Format để indent 2 khoảng trắng, 4 khoảng trắng hoặc tab, hoặc Compress để bỏ whitespace.
- Chuyển sang chế độ cây để thu gọn nhánh, hoặc đọc thông báo lỗi nếu tài liệu không well-formed.
Khi nào nên dùng
- Đọc response XML một dòng copy từ logs hoặc tab network.
- Xem SOAP envelope hoặc RSS feed lồng sâu mà không phải đếm thẻ đóng bằng tay.
- Tìm đúng dòng và cột của thẻ không khớp trước khi commit file cấu hình.
Syntax XML, namespace và những gì format không sửa được
Format chỉ thay đổi whitespace giữa các node. Nó không bao giờ viết lại dữ liệu của bạn và không thể biến tài liệu không hợp lệ thành hợp lệ.
- Mỗi element cần một thẻ đóng tương ứng, và tên thẻ phân biệt hoa thường: <Book> và <book> là hai element khác nhau.
- Giá trị attribute phải nằm trong dấu nháy, và namespace prefix như meta: phải được khai báo bằng attribute xmlns.
- Text trong CDATA section được giữ nguyên văn, nên nội dung trông giống markup ở đó không bao giờ bị indent lại.
XML Formatter FAQ
- XML beautifier và XML pretty printer có phải là một không?
- Đúng. Beautify, pretty print và format đều chỉ cùng một thao tác: thêm xuống dòng và indent mà không đổi dữ liệu.
- Format có làm thay đổi dữ liệu không?
- Không. Chỉ whitespace giữa các node thay đổi. Thứ tự element, attribute và nội dung CDATA giữ nguyên.
- XML của tôi có bị tải lên server không?
- Không. Parse, format và kiểm tra đều chạy cục bộ trong trình duyệt và không có gì được gửi tới wetool.site.
XML Formatter và kiểm tra bằng XML Schema
Công cụ này kiểm tra tài liệu có well-formed hay không: thẻ khớp nhau, dấu nháy đóng đủ, lồng nhau hợp lệ. Nó không đối chiếu XML với XSD hay DTD, nên tài liệu well-formed vẫn có thể vi phạm schema.
Đọc XML dưới dạng cây thu gọn được
XML viewer hiển thị cấu trúc thay vì văn bản. Chế độ cây là cách nhanh nhất để hiểu một tài liệu lạ, vì bạn có thể thu gọn những nhánh không quan tâm.
- Mỗi element thành một node hiển thị tên thẻ và attribute, nên bạn thấy hình dạng tài liệu chỉ trong một cái nhìn.
- Thu gọn một nhánh sẽ ẩn cả subtree, giúp so sánh các bản ghi lặp như <book> hay <item> dễ hơn nhiều.
- Thứ tự các phần tử cùng cấp giữ đúng như đã viết, và các element trùng tên không bao giờ bị gộp lại.
Kiểm tra XML và đọc lỗi
XML validator báo vị trí đầu tiên tài liệu không còn well-formed, kèm dòng và cột để bạn nhảy tới.
- Lỗi thẻ không khớp nêu cả thẻ đóng tìm thấy lẫn dòng khai báo thẻ mở tương ứng.
- Giá trị attribute thiếu dấu nháy và ký tự < hoặc & bị lạc là hai nguyên nhân phổ biến nhất khiến parse thất bại.
- Số dòng và số cột do chính parser tính, nên giống hệt nhau trên Chrome, Firefox và Safari.