XML DOM surroundContents() yöntemi
Tanım ve Kullanım
surroundContents() yöntemi belirli bir nodu içerik aralığının etrafına sarar.
Sözdizimi:
surroundContents(newParent)
parametre
parametre | tanımlama |
---|---|
newParent | Yeni içerik aralığının anahtarı olan yeni ebeveyn节点的节点. |
fırlatılır
Bu yöntem aşağıdaki durumlarda belirli kodu olan hatayı fırlatacak. DOMException hatasıveya RangeException hatası:
DOMException.HIERARCHY_REQUEST_ERR
mevcut aralığın başlangıç noktasının içeren nodunun alt nodu olmamalı, aynı zamanda newParent tipinin alt nodu veya newParent Bir içeren节点的ata nodu.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Mevcut genişliğin sınırlayıcı noktalarının atalarından birisi yalnızca okunabilir, bu yüzden ekleme işlemine izin verilmez.
DOMException.WRONG_DOCUMENT_ERR
newParent ve genişliği farklı Document nesneleri ile oluşturulmuştur.
RangeException.BAD_BOUNDARYPOINTS_ERR
Mevcut genişlik, bir düğümü (Text düğümü dışında) kısmen seçmiş, bu yüzden belgenin bu bölgesini sarmak mümkün değildir.
RangeException.INVALID_NODE_TYPE_ERR
newParent Document, DocumentFragment, DocumentType, Attr, Entity veya Notation nodlarıdır.
tanımlama
Bu yöntem, mevcut genişliğin ana ebeveynini newParentve sonra newParent belgedeki bir bölgeyi <div> veya <span> elementi içinde yerleştirmek için bu yöntemi kullanabilirsiniz. Örneğin:
Eğer newParent zaten belge'nin bir parçasıysa, önce belgeden kaldırılır, alt nodları da atılır. Bu yöntem geri döndüğünde, bu genişlik belge'den kaldırılmış olacak ve newParent Önceki konum, başlangıç noktasıdır,newParent Sonraki konum, bitiş noktasıdır.